home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / langs / gemfst18.lzh / AES_VRSN.DOC next >
Encoding:
Text File  |  1992-12-06  |  5.3 KB  |  138 lines
  1.  
  2.  So many things changed on the aes side that you're best off just reading
  3.  the new gemfast function reference doc.  Below is a list of changes I 
  4.  started, but I'm not sure I even recorded every new function, let alone
  5.  the descriptions of the changes.  Still, I've been sitting on this release
  6.  for six months already, and I'm not going to hold it up any longer just
  7.  because I don't have time to flesh out these notes right now.  ::sigh::
  8.  
  9.  Version notes for AESFAST...
  10.  
  11.  v1.8   02/21/91    Miscellanious fixes and additions.
  12.  
  13.    - apl_malloc     New stuff.  As the utilities get more complex, they
  14.      apl_free       need more system-level services.  You can provide the
  15.                     services by coding these routines, or let default
  16.                     routines be picked up from the aesfast library.
  17.  
  18.    - apl_vopen      New.  These functions open and close a VDI workstation
  19.      apl_vclose     and implement the (new) concept of a single shared
  20.      apl_vshared    workstation which all gemfast utilties will use.  Your
  21.                     application can use it too, or can also use this to
  22.                     open a separate (private) workstation for its own use.
  23.  
  24.    - appl_init      Now appl_init/exit are vectored through apl_xinit/xexit
  25.      appl_exit      functions via macros in GEMFAST.H.  This revectoring
  26.      apl_xinit      is required to use new utilties.  The xinit/xexit
  27.      apl_xexit      functions just set up some new gl_whatever global vars.
  28.  
  29.    - apl_cleanup
  30.  
  31.    - frm_dsdial     Renamed to frm_dsdialog(), and switched around the
  32.                     order of the parms.  A macro in GEMFAST.H provides
  33.                     compatibility with existing code. Also, any string that
  34.                     starts with 0x7F is now centered.  It also recognizes
  35.                     several new values in the graphicflag parameter.
  36.  
  37.    - frm_nldialog   New.  This builds and conducts a dynamic string dialog
  38.                     like frm_dsdialog() does, but the text lines are
  39.                     passed as one huge string with NL delimiting each line.
  40.  
  41.    - frm_dialog     New.  This conducts a complete dialog, or just part
  42.                     of one, based on the flags you pass to it.
  43.  
  44.    - frm_printf     New.  Does about what you'd think: you pass it parms
  45.      frm_vprintf    like you would to printf() (or vprintf()), and it makes
  46.                     a dialog out of it.  (You also pass buttons, and it
  47.                     returns the exit button number, so this is really
  48.                     what form_alert() always should have been).
  49.  
  50.    - frm_confine
  51.    - frm_desktop
  52.    - frm_enableblit
  53.    - frm_sizes
  54.    - frm_error
  55.      frm_verror
  56.    - frmx_dial
  57.  
  58.    - exterror
  59.    - exterrset
  60.           
  61.    - fsl_dialog     New.  This conducts a complete file selector dialog.
  62.  
  63.    - grfx_dragbox
  64.  
  65.    - grf_blit       New.  Blit between screen and memory buffer.
  66.  
  67.    - grf_memblit    New.  Either allocates a memory buffer and saves a
  68.                     piece of the screen into it, or restores the screen
  69.                     then frees the buffer.
  70.  
  71.    - mnu_bar
  72.      mnu_enable
  73.      mnu_disable
  74.  
  75.    - obj_clcalc
  76.  
  77.    - obj_mxuserdef
  78.  
  79.    - obj_ppstring
  80.  
  81.    - rc_intersect   Now returns FALSE when the width or height of the
  82.                     resulting rectangle is zero.  Also, now copes with
  83.                     negative x/y values properly (but width and height
  84.                     better be >= 0).
  85.  
  86.     - rc_gtov       The gtov now calcs ending x as grect->x+grect->w-1.
  87.       rc_vtog       Likewise for the y.  (It didn't used to apply the -1
  88.                     adjustment.)  The vtog has the inverse adjustment.
  89.                     I hope this doesn't break any existing code, but the
  90.                     old way was wrong.  For example, it would convert
  91.                     the mono desktop grect to (0,0,640,400) and if you pass
  92.                     that to VDI v_bar() you end up drawing a box 1 pixel
  93.                     bigger than the screen.
  94.  
  95.    - rc_intersect   Now returns FALSE when the width or height are zero.
  96.  
  97.    - rc_confine
  98.  
  99.    - rsc_rrbuttons
  100.  
  101.    - rsc_cubuttons
  102.  
  103.    - rsc_gtrees     New.  Gets the address of multiple resource trees in
  104.                     one call.  Like what rsc_gstrings() does for strings.
  105.  
  106.    - wind_update    Now vectored through wnd_update() function.  The new
  107.      wnd_update     function treats wind_update() calls in a stack-like
  108.                     fashion, just like graf_mouse().  If you do BEG_UPDATE
  109.                     3 times, then it takes 3 END_UPDATE calls before the
  110.                     real wind_update(END_UPDATE) is passed to the AES.
  111.                     Same deal with BEG/END_MCTRL.  This is required for the
  112.                     new utility functions, which need to change the update
  113.                     status without hosing up the application.  Since both
  114.                     the utils and the ap are forced through wnd_update(),
  115.                     the stack-like logic keeps it all straight.
  116.                     
  117.  
  118.    - frm_mdo
  119.    - frm_menu
  120.    - frm_dsmenu
  121.    - frm_nlmenu
  122.    - rc_ptinrect
  123.    - frm_move
  124.    - frm_init
  125.    - frm_cleanup
  126.    - frm_start
  127.    - frm_draw
  128.    - frm_do
  129.    - frm_finish
  130.    
  131.    - frm_question
  132.    - frm_qmenu
  133.    - frm_qerror
  134.    - frm_qtext
  135.    - wnd_top
  136.    
  137.    
  138.